United Public Domain Gold 4/United Public Domain Gold 4.iso/scope/sc168.dms/sc168.adf/Serial/HELP.C

Text File | 1990-11-16 | 4KB | 78 lines

int help( )
{
   printf("   \n " ) ;
   printf("SERIAL.C - Released date: 21-SEP-1990  \n " ) ;
   printf("   \n " ) ;
   printf("  By: Ned Kelly  \n " ) ;
   printf("      Arlington, Texas  \n " ) ;
   printf("      817-277-5825  \n " ) ;
   printf("   \n " ) ;
   printf("  This program is designed to monitor th" ) ;
   printf("ree status lines (DTR, CTS, CD) \n " ) ;
   printf("on a serial port.  In the event that any" ) ;
   printf(" status line has changed, an \n " ) ;
   printf("event is sent to an ARexx task which wil" ) ;
   printf("l decide what to do with the \n " ) ;
   printf("event.  \n " ) ;
   printf("   \n " ) ;
   printf("  Calling sequence is:  \n " ) ;
   printf("     SERIAL p U u [D d] [Q l u v] [L n]  \n " ) ;
   printf("        where 'p' is the name of the ARe" ) ;
   printf("xx program to be invoked. \n " ) ;
   printf("        where 'u' is a unit number of a " ) ;
   printf("serial port to watch.  This \n " ) ;
   printf("              must be a number between '" ) ;
   printf("0' and '8'. \n " ) ;
   printf("              A unit must be sepcified. " ) ;
   printf(" There is no default. \n " ) ;
   printf("              Multiple units may be spec" ) ;
   printf("ified in a single call. \n " ) ;
   printf("              ie. SERIAL PROGRAM U 3 U 5" ) ;
   printf(" U 7 \n " ) ;
   printf("        where 'd' is a delay in units of" ) ;
   printf(" 1/50 second to wait between \n " ) ;
   printf("              checks of the serial port(" ) ;
   printf("s). \n " ) ;
   printf("              Default is 50 (ie. one sec" ) ;
   printf("ond). \n " ) ;
   printf("        The program will terminate under" ) ;
   printf(" one of two conditions. \n " ) ;
   printf("        If neither the 'Q' nor the 'L' o" ) ;
   printf("ption are specified, \n " ) ;
   printf("        the program will do it's thing o" ) ;
   printf("nce and then terminate. \n " ) ;
   printf("           If the 'Q' option is specifie" ) ;
   printf("d, then the program will \n " ) ;
   printf("              terminate when line 'l' (w" ) ;
   printf("hich may be either 'CD', 'CTS', \n " ) ;
   printf("              or 'DSR') on unit 'u' (whi" ) ;
   printf("ch may be a number from '0' \n " ) ;
   printf("              through '8') becomes value" ) ;
   printf(" 'v' (which may be either \n " ) ;
   printf("              '0' or '1').  \n " ) ;
   printf("           If the 'L' option is specifie" ) ;
   printf("d, then the program will \n " ) ;
   printf("              loop through 'n' times and" ) ;
   printf(" then quit. \n " ) ;
   printf("     When a status line has changed, pro" ) ;
   printf("gram will issue the command: \n " ) ;
   printf("        rx p SERIAL [l u v]  \n " ) ;
   printf("           where 'l' is the name of a st" ) ;
   printf("atus line which will be either \n " ) ;
   printf("                 CD, CTS, or DSR  \n " ) ;
   printf("           where 'u' is the unit number " ) ;
   printf("of the serial port which will \n " ) ;
   printf("                 be a number from '0' th" ) ;
   printf("rough '8'. \n " ) ;
   printf("           where 'v' will be either a '0" ) ;
   printf("' or a '1'. \n " ) ;
   printf("                 'v' will be '0' if the " ) ;
   printf("status line is open \n " ) ;
   printf("                     (not grounded).  \n " ) ;
   printf("                 'v' will be '1' if the " ) ;
   printf("status line is closed \n " ) ;
   printf("                     (grounded).  \n " ) ;
   printf("   \n " ) ;
   return( 0 ) ;
}